home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Development Platforms / Apple II / Essentials / Human.Int.Notes / HIN.005 < prev    next >
Encoding:
Text File  |  1990-02-21  |  8.1 KB  |  155 lines  |  [TEXT/pdos]
  1. Human Interface Notes
  2. _____________________________________________________________________________
  3.  
  4. Note #5    What "Cancel" Means
  5.     
  6.            Written by:  John Sullivan                            January 1990
  7. _____________________________________________________________________________
  8.  
  9. "Cancel" means "dismiss this operation, with no side effects."  It does not
  10. mean "done with the dialog box," "stop what you are doing no matter what,"
  11. or anything else.
  12. _____________________________________________________________________________
  13.  
  14. When to use Cancel
  15.  
  16. In alert or dialog boxes, use Cancel for the name of a button that closes the
  17. alert or dialog box and returns the system to the state it was in before the
  18. alert or dialog box was displayed.  When a lengthy operation is in progress, 
  19. use Cancel for the name of a button that dismisses the operation and returns 
  20. the machine to the state it was in before the operation began, with no side 
  21. effects.
  22.  
  23.  
  24. What to do the rest of the time
  25.  
  26. When it is impossible to return to the state that existed before an operation 
  27. began, do not use the word Cancel.  Two common alternatives, useful in
  28. different situations, are OK and Stop.
  29.  
  30. In alert or dialog boxes, use OK for the name of a button that closes the alert
  31. or dialog box and accepts any changes made while it was displayed.  For
  32. confirmation alerts (alerts that say, essentially, "Are you sure you want to
  33. do this?") and many simple dialog boxes, it is better to use a word or two that
  34. succinctly describes what accepting the alert or dialog box means, such as 
  35. Revert or Change All.
  36.  
  37. When a lengthy operation is in progress, use Stop for the name of a button 
  38. that halts the operation before its normal completion, accepting the possible 
  39. side effects.  Stop may leave the results of partially-completed tasks around, 
  40. but Cancel never does.
  41.  
  42.  
  43. Some correct examples
  44.  
  45. Following is a series of examples of proper uses of Cancel 
  46. and its cousins.
  47.  
  48. |--------------------------------------------------------------------|
  49. | ================================================================== |
  50. | |     /\            Revert to the last saved version             | |
  51. | |    /  \           of "The Big Red Book"?                       | |
  52. | |   / !  \                                                       | |
  53. | |   ------                                                       | |
  54. | |                                                                | |
  55. | |                          ___________        #############      | |
  56. | |                         /  Cancel   \     //    Revert   \\    | |                                                      
  57. | |                         \___________/     \\_____________//    | |
  58. | |                                             #############      | |
  59. | |================================================================| |
  60. |--------------------------------------------------------------------|
  61.  
  62.                      Figure  1 - Confirmation alert
  63.  
  64. The alert in Figure 1 uses Revert instead of OK, since Revert 
  65. neatly sums up what accepting the alert means.                 
  66.                      
  67. |--------------------------------------------------------------------|
  68. | ================================================================== |
  69. | |                  Cat Detector (tm)  options                    | |
  70. | |                                                                | |
  71. | |    Pinpoint a purr at:      Cat licence price  (L):            | |
  72. | |                                                                | |
  73. | |    O  40 yards                           +                     | |
  74. | |    @  60 yards                      15   |                     | |
  75. | |    O  80 yards                           -                     | |
  76. | |                           ___________        #############     | |                                              
  77. | |                          /  Cancel   \     //     OK      \\   | |
  78. | |                          \___________/     \\_____________//   | |
  79. | |                                              #############     | |
  80. | |================================================================| |
  81. |--------------------------------------------------------------------|
  82.  
  83.           Figure 2 - More Complex dialog with Cancel and OK
  84.  
  85. The dialog box in Figure 2 uses OK because there is no succinct term to 
  86. describe what accepting the changes in the dialog box means.
  87.  
  88.  |------------------------------------------------------------------|
  89.  | ================================================================ |
  90.  | |                            Custom Formats                    | |
  91.  | |                           --------------                     | |
  92.  | |      _______________________________        __________       | |
  93.  | |      |##That Format ############|/\|       /   New    \      | |
  94.  | |      |##########################|__|       \__________/      | |
  95.  | |      |                          |  |        __________       | |
  96.  | |      |  This Format             |  |       /  Remove  \      | |
  97.  | |      |                          |  |       \__________/      | |
  98.  | |      |  Yet Another Format      |  |        __________       | |
  99.  | |      |                          |  |       /  Modify  \      | |
  100.  | |      |                          |  |       \__________/      | |
  101.  | |      |                          |  |        __________       | |
  102.  | |      |                          |__|       /   OK     \      | |
  103.  | |      |                          |\/|       \__________/      | |
  104.  | |      |__________________________|__|                         | |
  105.  | |                                                              | |
  106.  | |==============================================================| |
  107.  |------------------------------------------------------------------|
  108.  
  109.         Figure 3 - More complex dialog with OK instead of Cancel
  110.  
  111. The dialog box in Figure 3 uses OK because it doesn't throw away all the 
  112. changes that were made since the dialog box was first drawn.  If the button
  113. were named Cancel instead, clicking it would remove any formats created since 
  114. the dialog box was drawn, bring back any formats removed since the dialog box
  115. was drawn, and undo any changes that had been made by selecting a format and 
  116. clicking Modify since the dialog box was drawn.
  117.                   
  118.         |-------------------------------------------------|
  119.         | =============================================== |
  120.         | |                                             | |
  121.         | |  Inserting the file "Really long document"  | |
  122.         | |  into "Wombat data" ...                     | |
  123.         | | ________________________________  ________  | |
  124.         | ||###### ////////////////////////| / Cancel \ | |
  125.         | ||######/////////////////////////| \________/ | |
  126.         | ||-------------------------------|            | |
  127.         | |                                             | |
  128.         | |=============================================| |
  129.         |-------------------------------------------------|
  130.  
  131.            Figure 4 - Progress indicator that uses Cancel
  132.  
  133. The dialog box in Figure 4 uses Cancel because clicking the button leaves
  134. the document named Wombat Data in the state it was in before the Insert 
  135. File command was chosen.
  136.  
  137.         |-------------------------------------------------|
  138.         | =============================================== |
  139.         | |                                             | |
  140.         | |  Inserting the file "Really long document"  | |
  141.         | |  into "Wombat data" ...                     | |
  142.         | | ________________________________  ________  | |
  143.         | ||########///////////////////////| /  Stop  \ | |
  144.         | ||########///////////////////////| \________/ | |
  145.         | ||-------------------------------|            | |
  146.         | |                                             | |
  147.         | |=============================================| |
  148.         |-------------------------------------------------|
  149.  
  150.             Figure 5 - Progress indicator that uses Stop
  151.  
  152. The dialog box in Figure 5 uses Stop because clicking the button stops 
  153. inserting text into the document named Wombat Data, but it doesn't remove 
  154. the text that has already been inserted.
  155.